home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Atari Mega Archive 1
/
Atari Mega Archive - Volume 1.iso
/
cli
/
cpp2.lzh
/
CPP2.DOC
next >
Wrap
Text File
|
1985-11-20
|
6KB
|
133 lines
------------------------------------------------------------------------------
ATARI STtm COMMAND PROCESSOR PROGRAM v1.0a
DOCUMENTATION
By: James M. Eli
------------------------------------------------------------------------------
Caveats of this version:
1. No redirection.
2. No single drive (2 disk) copies.
The following is a list and brief description of the supported intrinsic
commands. Specifications enclosed in brackets ( '<' and '>' ) are
optional arguments to the basic commands. A short example is also given.
INTRINSIC COMMANDS:
------------------------------------------------------------------------------
1. CLS
Clears the screen.
2. DIRECTORY <drive> <pathname> <filename.ext>
Displays file names and file sizes of the specified directory or
defaults to the current drive / directory. Wildcards ( '?' and
'*' ) are allowed. It then reports remaining bytes free.
Example: 'DIR A:*.PRG'
3. DELETE <drive> <pathname> filename.ext
ERASE <drive> <pathname> filename.ext
Irreversibly deletes the specified file.
Example: 'DEL A:COMMAND.PRG'
4. RENAME <drive> <pathname> filename.ext <drive> <pathname> filename.ext
Renames the first specified file to the second specified name.
Example: 'RENAME A:CPP.PRG A:COMMAND.PRG'
5. VERSION
Displays the initial copyright message along with the current
version number.
Example: 'VER'
6. TYPE <drive> <pathname> filename.ext
Displays a text file on the screen. Same as a copy to the
console. It is the users responsiblity to determine the type
of file prior to using this command. The control-S combination
of keystrokes pauses output, while control-Q restarts the ouput.
Example: 'TYPE B:CPP.DOC'
7. COPY <drive> <pathname> filename.ext <drive> <pathname> filename.ext
Copy from one file to another. If destination already exists
source is appended to the destination. Both filenames must be
specified. Does not allow swapping of disks on a single drive
copy (the buffer is only 4K and would necessitate endless
switching of disks). The following destinations are also
supported: 'CON:' (console), 'PRT:' or 'LPT:' (parallel port),
'AUX:' or 'SER:' (serial port).
Example: 'COPY A:PROGRAM.PRG B:\GAMES\PROGRAM.PRG'
8. CDIR <drive> pathname
Changes to the specified directory or returns to the top most
directory if no pathname is specified.
Example: 'CDIR A:TEXT'
9. MKDIR <drive> pathname
Creates a new subdirectory with the name specified.
Example: 'MKDIR A:TEXT'
10. RMDIR <drive> pathname
Removes an empty existing subdirectory. If files are present,
a message indicating this is displayed, and the command is
aborted.
Example: 'RMDIR A:TEXT'
11. EXIT
QUIT
Terminates the CP program and returns to the desktop.
12. ECHO
Determines if commands during a batch process are displayed.
Simply toggles on / off the displaying of commands.
Example: 'ECHO'
13. REM <message>
A batch command which displays <message> if echo is on. If echo
is off then the message is not displayed. The command is
useful for placing explanatory notes inside the batch file.
Example: 'REM *** ARCHIVE BATCH FILE ***'
If the command entered is not an intrinsic one (see above) we first
assume it to be a switch of the default drive and attempt to change it. The
prompt will reflect a change in the default (caution: no error checking here,
so you could possibly crash the program by specifying 'Q:', '3:' or some other
silliness). Next, if it wasn't a change of defaults we attempt to execute it
as a VALID program. Valid is assumed because again no error checking is done.
The extension '.PRG' is appended automatically to the name (sorry .TOS). The
command line's tail is passed on (example: 'STWRITER CPP.DOC'). A simple
batch processor is incorporated also. Any text file with the '.BAT' extension
and less than 1024 bytes is a legal batch file. The batch subroutine will
accept up to 2 parameters (denoted by: '%1' and '%2'). Do not attempt to call
another batch file as it will destroy the calling file (it maybe possible to
call another at the very end of one... although this hasn't been tested).
Here is an example batch file named 'CC.BAT'
REM *** C BATCH COMPILE ***
compiler %1.c
improver %1.o
linker %1.o -o %1.prg
delete %1.o
This is called with a parameter, i.e. ' CC CPP '. Note the extensions are
automatically appended.
Intrinsic commands can be abbreviated to a reasonable point, but you
must be careful. As a fallout of this, no program can have a filename the
same as an intrinsic command or batch file. The control-C key combination
will generally terminate the current command and also return the user back
to the desktop (why and how can I avoid this). What I attempted to do here
was to simulate an MS-DOS type environment, hence the basic similarity.
The follow-on versions will correct current bugs and (intends) incorporate
some of the caveats. To wet your appetite, the goal is to have a shell that
is functionally identical to MS-DOS.
This program is not in the public domain and cannot be sold. It may be
freely distributed as long as the copyright message remains intact. Please
distribute it with these instructions so users know of the caveats. Certainly
any donations for my effort, constructive criticism or suggestions are highly
encouraged and genuinely welcome. I may be reached at:
James Eli (74176,2137)
613 Paddy Run Rd.
Clarksville, TN 37042
əəəəəəəəəəəəəəəəəəəə